home *** CD-ROM | disk | FTP | other *** search
/ Aminet 31 / Aminet 31 (1999)(Schatztruhe)[!][Jun 1999].iso / Aminet / comm / news / slrn-src.lha / slrn / doc / VMS-SLRN.HLP < prev   
Text File  |  1998-05-03  |  34KB  |  961 lines
  1. 1 slrn
  2.      slrn - An easy to use NNTP based newsreader.
  3.  
  4. SYNOPSIS
  5.      slrn [ -n ] [ -h nntp-server-name ] [ -f newsrc-file ] [   -
  6.      create ] [ -C ] [ -help ]
  7.  
  8. 2 DESCRIPTION
  9.      slrn is an easy to use but powerful NNTP  based  newsreader.
  10.      It relies extensively on the S-Lang programmer's library for
  11.      many of its features.
  12.  
  13.      If no server is specified on the command line using the  - h
  14.      option,  the  server specified by the NNTPSERVER environment
  15.      variable will be used.  The -f option specifies which newsrc
  16.      file  should be used.  If none is specified, a default value
  17.      of JNEWS.RC will be used. This value can be set on a  server
  18.      by server basis using the SLRN.RC initialization file.
  19.  
  20.      The -create option should be used the  first  time  slrn  is
  21.      used  for  a particular server. This causes slrn to read the
  22.      entire list of groups available at the server and place them
  23.      in  the  selected  newsrc  file.   If the NNTP connection is
  24.      slow, this process may take several  minutes.   Fortunately,
  25.      this happens only when the -create flag is used.
  26.  
  27.      If -C is specified on the  command  line,  the  terminal  is
  28.      assumed to support colors.  Colors may be specified by using
  29.      the initialization file.  If the -n option  is  present,  no
  30.      new  newsgroups  will  be checked for.  This may result in a
  31.      faster startup.
  32.  
  33.  
  34. 2 BASIC_OPERATION
  35.      Using slrn is simple.  For many,  simply  typing  slrn  will
  36.      connect  to  a  news server. After starting, slrn checks for
  37.      the existence of new newsgroups and automatically subscribes
  38.      to  them.  Then  after  new  news is checked, slrn goes into
  39.      ``full screen'' mode at which point the user can unsubscribe
  40.      to  one  or  more  groups. slrn will display a list of news-
  41.      groups that looks like:
  42.  
  43.      ->  3      sci.research.postdoc                 689-705
  44.          1      comp.databases.olap                  1-1
  45.          4      rec.antiques.radio+phono             1-4
  46.          1      comp.emulators.ms-windows.win        339-349
  47.        113      comp.unix.questions                  74401-74513
  48.         11      gnu.ghostscript.bug                  4874-4884
  49.        100      alt.music.pink-floyd                 7941-8040
  50.         11      rec.sport.baseball.analysis          239-249
  51.          3      rec.sport.baseball.data              267-269
  52.         13      sci.physics.electromag               1159-1171
  53.         65      comp.sys.ibm.pc.hardware.systems     4754-4818
  54.          5      sci.physics.particle                 1069-1073
  55.          2      comp.sources.x                       2362-2363
  56.          2      comp.unix.user-friendly              2603-2604
  57.  
  58.      Here the middle column shows the name of a newsgroup and the
  59.      left  column  shows  the  number  of  unread articles in the
  60.      group. The right column shows the range of articles  present
  61.      on  the  server.  Note  the  presence of the -> in the first
  62.      column on the `sci.research.postdoc' line.  This  symbol  is
  63.      used by slrn as a pointer to indicate the currently selected
  64.      line. It may be moved up and down by using the  arrow  keys.
  65.      Pressing  the  RETURN key or the SPACEBAR at this point will
  66.      select the `sci.research.postdoc' group. A new  screen  will
  67.      appear showing something like:
  68.  
  69.      ->-        703        (P)      Lecturer       in       Comp.
  70.      dumontet@nuri.inria.fr (dumo
  71.        -         704         Research       &        Developnment
  72.      dumontet@nuri.inria.fr (dumo
  73.        -        705        Re:      Example      of      proposal
  74.      shinbrot@bart.chem-eng.nwu.e
  75.  
  76.      Here, each line consists of four fields and possibly the - >
  77.      cursor.  The  first  field indicates whether the article has
  78.      been read or not. A hyphen ( - ) in the  first  field  indi-
  79.      cates  that  the  article has not been read.  Since a hyphen
  80.      appears in the first field in all three of the lines  above,
  81.      none  of  the articles have been marked as read. A d in this
  82.      field indicates that an article has been read. The currently
  83.      selected  article can be changed from the read to the unread
  84.      state by pressing the u key. The d key may be used  to  mark
  85.      the  article as read without actually reading it.  The c key
  86.      may be used to mark all the articles as read (Actually  this
  87.      is  the  preferred way to use the newsreader: scan the arti-
  88.      cles by eye looking for something  interesting  then  before
  89.      moving  on to next newsgroup, press `c' to mark all articles
  90.      as read).
  91.  
  92.      The second field displays the server number of the  article.
  93.      The  third  and fourth fields contain the subject and author
  94.      of the article, respectively.
  95.  
  96.      Pressing the SPACEBAR or the RETURN key will create a second
  97.      window  and  display  the contents of the currently selected
  98.      article. The screen will now consist  of  two  windows  -  a
  99.      large  one  and  a small one. The large window, known as the
  100.      article window, will contain the currently selected  article
  101.      and the small one, known as the summary window, will contain
  102.      the list of articles as shown above. The space  bar  may  be
  103.      used  the  scroll  the article forward and the DELETE key or
  104.      the `B' key may be used to scroll it backward.  The  UP/DOWN
  105.      arrow  keys  simply  move  the   - > cursor from one line to
  106.      another in the summary window. To hide the  article  window,
  107.      press  the  h  key.This will zoom the summary window to full
  108.      screen.
  109.  
  110.      The f key may be used to post a followup  to  the  currently
  111.      selected article. To return to the list of Newsgroups, press
  112.      the Q key to leave this mode.
  113.  
  114. 2 DEFAULT_KEYBINDINGS
  115.      These keybindings are always available:   These  keybindings
  116.      are always available:
  117.  
  118.      ?    Help
  119.  
  120.      PageUp Ctrl-U
  121.           Page up
  122.  
  123.      PageDn Ctrl-D
  124.           Page down
  125.  
  126.      Ctrl-Z
  127.           Suspend program
  128.  
  129.      These keybindings may be used at the newsgroup level:
  130.  
  131.      SPACE   Select articles for the current group.
  132.  
  133.      UP P    Move to the previous group
  134.  
  135.      DOWN    Move to the next group
  136.  
  137.      q       Quit the program
  138.  
  139.      p       Post an article
  140.  
  141.      l       Toggle the display of groups with no unread articles
  142.              on and off
  143.  
  144.      L       Toggle display of unsubscribed groups (can also sub-
  145.              scribe with this)
  146.  
  147.      u       Unsubscribe from the current group
  148.  
  149.      s       Subscribe to the current group
  150.  
  151.      c       Mark all articles in the current group as read.
  152.  
  153.      a       Subscribe to a specified group
  154.  
  155.      /       Search for a subscribed group
  156.  
  157.      G       Refresh groups from news server
  158.  
  159.      X       Save .newsrc
  160.  
  161.      ESC >   Move to last group
  162.  
  163.      ESC <   Move to first group
  164.  
  165.      The following bindings are valid once a newsgroup  has  been
  166.      selected:
  167.  
  168.      SPACE   Select or scroll currently selected article forward
  169.  
  170.      DELETE, b
  171.              Scroll currently selected article backward
  172.  
  173.      d       Mark currently selected article as read and move  to
  174.              the next unread article.
  175.  
  176.      u       Mark the currently selected article as unread
  177.  
  178.      #       Numerically tag the article for multiple save (see o
  179.              command)
  180.  
  181.      g       Skip to next digest
  182.  
  183.      h       Hide the article window by zooming the summary  win-
  184.              dow to full screen
  185.  
  186.      Ctrl-^  Decrease the size of the header window by one line.
  187.  
  188.      ^       Increase the size of the header window by one line.
  189.  
  190.      f       Post follow-up to the currently selected article
  191.  
  192.      F       Forward the currently selected article to someone
  193.  
  194.      r       Reply  directly  to  the  author  of  the  currently
  195.              selected article
  196.  
  197.      o       Save the currently selected article or thread  to  a
  198.              file  in  a  Unix mail format by appending it to the
  199.              the specified file, then optionally decode the arti-
  200.              cles with uudecode or unshar.  If numerically tagged
  201.              articles (see # ) are present, then optionally  save
  202.              and  then  decode the tagged articles.  The built-in
  203.              uudecoder can decode